Skip to main content

Google Drive Event Channel

Google Drive Event ChannelThe menu is a screen for installing and managing drive-level change notification (webhook) channels to apply the SHIELD DRM service to Google Drive.

Microsoft 365's이벤트 리시버This is a Google Workspace-specific integration management menu that is displayed only to customers using Google Workspace.

Google Drive is a change notification (webhook) method for installing channels on a drive basis. Channels have an expiration time and are automatically re-registered periodically. Document events from drives where channels are not installed are not received, and conditional policies are not applied.


Prerequisites​

To use the Google Drive event channel, the following conditions are required:in orderIt must be prepared. If the previous step is not prepared, the state will not change even if the next step is executed.

#conditionSubject to be equipped
1The customer company uses Google Workspace, and the tenant must be integrated with SHIELD DRM.Client Administrator · Implementation Manager
2Google Drive 이벤트 채널You must have role permissions.SHIELD DRM Manager
3Each user's SHIELD ID account must be linked to a Google Workspace account.SHIELD ID Manager(Personnel Linkage)
4The target user and drive must be reflected in the list.SHIELD DRM Manager (동기화)

The order after conditions 1 and 2 are met is as follows.Account linking (Step 1) is done through SHIELD ID, not SHIELD DRM.

User Account Linking (Condition 3)​

My Drive Channel isInstallation by userTherefore, you must know the Google Workspace account of the target user in order to install. This connection is**SHIELD ID's Personnel Integration (Directory Synchronization)**is created.

The path where the connection is madeExecutor
SHIELD ID Personnel Linkage — Automatic SynchronizationIf set, will automatically reflect periodically
SHIELD ID Personnel Integration — Manual SynchronizationDirect execution by the SHIELD ID administrator
User logs in to SHIELD ID with Google accountUser himself (Automatically connected upon login)

⚠️ If automatic synchronization is not set, the account will not connect even if it exists in both SHIELD ID and Google Workspace.In this case, the SHIELD ID administratorRun manual synchronizationYou need to connect. A new member has joined or the list of사용자 IDIf it is empty, please check this item first.

  • Connection status is내 드라이브tab's사용자 IDCheck by heat. Google Workspace email addresses are only displayed to connected users.
  • Unconnected usersThis is not a channel installation target. 채널 설치I전체 설치The user's status does not change even if executed.
  • There is no separate notification screen to indicate that the connection has been completed. Above사용자 IDCheck by row.

Screen Configuration​

SHIELD DRM Admin Page연동 관리 > Google Drive 이벤트 채널Click on the menu to access.

It is provided in two tabs according to the difference in event recipients.

  • **My Drive Tab:**Manage the channel installation status of personal drives (My Drive) on a user basis.
  • **Shared Drive Tab:**Manage the installation status of channels by the organization's shared drive unit.

The two tabs are independently queried, installed, and synchronized. When you switch tabs, the search term, filter, and page position are reset.

Each tab automatically installs the channel on newly created targets.실시간 감지There is a switch. For more details, please refer to "Real-time Detection" below.


My Drive​

List Information​

itemDescription
UserThe display name of the SHIELD ID user.
User IDThis is the Google Workspace email address linked to your SHIELD ID user account.**Information will be displayed only if a connected account exists.**If empty, it is not a target for channel installation (Prerequisite 3).
Channel Installation StatusIndicates whether a change notification channel is installed on the user's My Drive.
Last checked dateThe time when the channel status was last checked. It is displayed based on the time zone of the connection environment.

Channel Installation Status​

  • 설치: The notification channel has been installed successfully.
  • 미설치: The channel is not installed. Document events for the specified drive will not be received.
  • 지원하지 않음: This is the case when the account cannot use Google Drive, such as when it is not a target for channel installation.

채널 설치 상태Clicking the filter icon of the column allows you to filter the list by status. Only one status can be selected at a time, and초기화Release with the button.

status설치Order of Confirmation When Not​

사용자 ID **Please check the column first.**Even users from the same organization may have their status displayed differently depending on whether the HR integration is reflected.

statusFirst, check it.Action
미설치사용자 IDWhether the email is displayed in the columnIf empty → After reflecting SHIELD ID personnel linkage동기화(Precondition 3) When displayed →채널 설치or전체 설치Execution
지원하지 않음사용자 IDWhether the email is displayed in the columnIf empty → After reflecting SHIELD ID personnel linkage동기화(Prerequisite 3) If displayed → Check the availability of Google Drive for the corresponding account
I ran the installation, but it remains the same.how long has it been since it was executedSince it is a request reception method, please wait a moment.새로 고침to confirm again

in the search box at the top rightUsername or EmailIf you enter and press the Enter key or click the search icon, only that user will be retrieved.


Shared Drive​

List Information​

itemDescription
Drive NameThis is the name of the shared drive.
Drive IDThe unique identifier of the shared drive.
Channel Installation StatusIndicates whether a change notification channel is installed on the shared drive.
Last checked dateThis is the last time the channel status was checked.

Shared drives are all subject to channel installation, so unlike My Drive지원하지 않음The status is not displayed. It is also unrelated to user account connection (precondition 3).

In the search box,Drive NameEnter.


Channel Installation and Uninstallation​

Installation and Uninstallation of Selected Targets​

  1. Select the checkbox for the target item in the list. Clicking the checkbox in the header will select all items displayed on the current page.
  2. 채널 설치or채널 해제Click the button. If no items are selected, both buttons are disabled.
  3. When the request is received, a notification popup will be displayed and the list will be refreshed.

Channel installation and uninstallation isRequest Reception MethodIt operates as. Immediately after the request, the status may not be reflected in the list, and after a while새로 고침Please check again with the button.

Full Installation and Full Uninstallation​

Used when processing all items in the list at once.

  • 전체 설치: Install change notification channels for all targets in the current tab list.
  • 전체 삭제: Unsubscribes from the change notification channels for all targets in the current tab list.
  1. Select the tab to process (My Drive / Shared Drive).
  2. 전체 설치or전체 삭제Click the button.
  3. After confirming the target range in the confirmation window, proceed.

Two buttons areThe entire list of currently selected tabs regardless of row selectionis targeted. To process only the items selected with the checkbox,채널 설치 · 채널 해제Please use the button.

  • The two tabs operate independently, so to handle both My Drive and Shared Drive, you need to switch tabs and run them separately.
  • It may take time proportional to the number of targets. As with the selection execution, it is a request reception method, so shortly after새로 고침Please check the results.
  • in my drive tab전체 설치even if you runUsers without a connected account will not be installed.(Precondition 3).

Synchronization and Refresh​

  • 동기화: Retrieves and reflects the list of currently selected tabs again. My Drive and Shared Drive must be executed separately.
    • My Drive: Retrieves the active user list of SHIELD ID and the connected Google Workspace accounts for each user.
    • Shared Drive: Retrieves the list of shared drives in Google Workspace using the integration administrator account registered in the client settings.
  • 새로 고침: Retrieves the saved list again. SHIELD ID and Google Workspace queries are not performed.

This screen's동기화isUpdating the list of SHIELD DRMis. Precondition 3'sA task different from SHIELD ID personnel linkageand this button does not create a user account connection. After the connection is created through the personnel integration동기화or wait for the automatic refresh of the list사용자 IDIt will be displayed in the column.

When using for the first time and automatic list refresh​

  • The first-time customer is동기화Both tab lists are empty until the execution is completed.
  • 동기화Once the list is filled, SHIELD DRM automatically updates the lists of the two tabs every hour.
  • The shared drive list will be updated only if an admin account for integration is registered.
  • 동기화can only be executed once per minute in the same tab. If executed again within a minute, an error message will be displayed.

Real-time detection​

실시간 감지When activated, a change notification channel will be automatically installed for newly created users and shared drives.동기화You can wait for the automatic update of the list, and the administrator does not need to install it manually.

in the button area of each tab실시간 감지Set with the switch. My Drive and Shared Drive are set separately, and initially, both tabs are disabled.

tabAutomatic Installation TimingAutomatic Installation Target
My DriveWhen a user is newly added to Google Workspace or SHIELD IDUser Account Linking (Prerequisite 3) for Users' My Drive
Shared DriveWhen a shared drive is newly created in Google WorkspaceNewly created shared drive

Things to Prepare Before Activation​

Both tabs detect new users and shared drives with Google audit logs. To activate, the following two items must be prepared below.

  • A Google admin account for integration must be registered in the customer settings. The list of shared drives동기화It is the same as the account used when doing.
  • The domain-wide delegation audit log in the Google Admin Console should have the following scope:https://www.googleapis.com/auth/admin.reports.audit.readonlyIt is. If additional scope is needed, please contact the construction manager.

How to set up​

  1. Select the My Drive or Shared Drives tab.
  2. 실시간 감지Click the switch.
  3. Check the instructions of the confirmation window and계속Click.취소Clicking will return the switch to its original state.
  • When activating, it may take a few seconds as you register the Google audit log notification and then save it.
  • If the save fails, the switch will return to its original state, and a message box containing the error code will be displayed.
  • Google Drive 이벤트 채널The switch will be displayed as disabled for administrators without role permissions.
Error CodeCauseAction
282The Google administrator account for integration is not registered or is an account that does not exist in Google Workspace.After checking the integration administrator account for the customer company settings, reactivate it.
298There is no scope for viewing audit logs for full domain delegation.Re-enable after adding the range.
286Google call has temporarily failed.Try again shortly.
231Failed to save settings.Try again shortly.

Points to note​

  • It may take about 10 minutes from the creation of a new user or shared drive until the channel is installed. This is because it takes a few minutes to be recorded in the Google audit log.
  • It only works on newly created targets. It was in the list before activation.미설치Target is채널 설치or전체 설치to install.
  • User drives of users who have not completed account linking (precondition 3) will not be automatically installed.
  • Disabling will stop automatic installation. Any newly created targets will동기화You need to manually install it after it appears in the list with automatic updates.

Constraints​

This is an item that is not supported due to product structure or cannot be bypassed.

itemContent
User Account Linking**It relies on SHIELD ID personnel integration.**If automatic synchronization is not set, the account will not be connected even if it exists on both sides, and manual synchronization must be performed.
Channel Not Installed DriveDocument events are not received, and conditional policies are not applied.
New User · Drive실시간 감지inactive tabs do not activateIt is not detected in real-time. 동기화You need to run it or wait for the automatic list refresh that occurs every hour for it to appear in the list.
Automatic Installation실시간 감지in the activated tabOnly for newly created targetsThe channel is installed automatically. Other targets must be installed by the administrator directly.
Channel ExpirationThe channel has an expiration time and is automatically re-registered periodically.
Processing Reflection TimingInstallation and UninstallationRequest Reception MethodThis may not be reflected immediately.
Shared DriveSince all are installation targets,지원하지 않음There is no status.
Menu Display Conditions**It is displayed only to customers using Google Workspace.**In the Microsoft 365 environment,이벤트 리시버The menu serves the same purpose.
PermissionUse of the menuGoogle Drive 이벤트 채널You need role permissions. The install, uninstall, and sync buttons are not available to administrators without permissions.실시간 감지The switch will be disabled.

Caution​

  • 전체 설치**installs a channel on all targets in the current tab list.**If you run it from the My Drive tab, all users' My Drives in the list will be the target, so please check the target range before execution.
  • 전체 삭제**Executing this will stop receiving document events from all drives in that tab.**Documents on drives without channels are not subject to conditional policies.
  • When expanding the scope of policy application,Please check the installation status of the channel for the target drive first.
  • When a new member joins the organizationSHIELD ID Personnel Linkage Reflection Confirmation → 동기화 → 채널 설치It is recommended to check in order.